[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
VS_Die()             Alert the user of a serious error

Description:

  VS_Die() will display up to three lines of text as provided by the
  programmer. It will also display the message "Program Execution
  Halted". It will then EXIT after the user presses a key.  VS_Die()'s
  main use is to provide a way to inform the user of an error in program
  operation before shutting down.

Syntax:     

  VS_Die( c_Msg1, [c_Msg2], [c_Msg3] )

Pass:       

  c_Msg1 is a character expression that should contain the first
  line of text to show the user.

  c_Msg2 is an optional character expression that should contain the
  second line of text to show the user.

  c_Msg is an optional character expression that should contain the
  third line of text to show the user.

Return:     

  VS_Die() does not return!  It will issue a QUIT command.

Notes:      


Example:    

  IF error = .T.
      VS_DIE("An Error Got You!!!", "Better Luck Next Time", "This will
  be line three")
  ENDIF

Usage:      

  VS_Die() is a quick and dirty way to leave your application after
  telling the user some important message (such as why the shut down was
  necessary).

See Also:
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson